iMouse投屏 删除图片
调用说明
依赖 iMouse投屏 客户端
只在这台设备以 iMouse投屏 方式推流时可用,前置条件与 code 70~73 的含义见「iMouse投屏 相册列表」。
按图片 id 批量删除,支持多台设备同时删(各台并行)。
删除会弹 iOS 系统确认框,内核会替你点掉
iOS 删除照片必弹「允许"iMouse投屏"删除这张照片?」,手机端要等这个框被点了「删除」才会返回。
内核发出请求后等 auto_click 毫秒,自动替你点掉确认框;auto_click=0 则不点,此时你要自己在手机上点,接口会一直等到 outtime。
⚠️ 弹窗没被点掉时,后面所有相册请求都会超时(71),到手机上把弹窗点掉即可。
被删的照片进「最近删除」相簿,30 天内可在手机上恢复。
- 请求参数
| 参数 | 类型 | 说明 | 备注 |
|---|---|---|---|
| fun | 字符串 | /plugin/imcast/photo/del | 请求功能名 |
| id | 字符串 | 设备id | 多个设备用逗号隔开 |
| ids | 字符串数组 | 图片 id 列表 | 来自「图片列表」的 list[].id;多台时每台都删这批 id(各台 id 不同,通常只对一台用) |
| auto_click | 整数 | 发出删除后等多少毫秒去点确认框 | 不传默认 1500;0 不点 |
| outtime | 整数 | 超时时间 | 单位毫秒,不传或 0 用内核配置(默认 15 秒) |
- httpGet请求示例
curl --request GET \
--url 'http://192.168.9.9:9911/api/plugin/imcast/photo/del?id=6C:8D:C1:67:04:29&ids=%5B%227181C209-321B-4BA6-9D4E-B3B88AE0AD92%2FL0%2F001%22%5D'
- httpPost请求示例
curl --request POST \
--url http://192.168.9.9:9911/api \
--header "content-type: multipart/form-data" \
--form "fun=/plugin/imcast/photo/del" \
--form "id=6C:8D:C1:67:04:29" \
--form 'ids=["7181C209-321B-4BA6-9D4E-B3B88AE0AD92/L0/001"]'
- httpPost json请求示例【websocket也可发送同样json请求】
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/plugin/imcast/photo/del",
"data": {
"id": "6C:8D:C1:67:04:29",
"ids": ["7181C209-321B-4BA6-9D4E-B3B88AE0AD92/L0/001", "C8C4C2E5-FF89-48E3-8454-33248239EAE5/L0/001"],
"auto_click": 1500
}
}'
响应结果
{
"data": {
"list": [
{ "id": "6C:8D:C1:67:04:29", "code": 0, "message": "成功", "deleted": 2, "total_request": 2 }
],
"code": 0,
"id": "6C:8D:C1:67:04:29",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/plugin/imcast/photo/del"
}
- 响应data数据字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | 整数 | 全部设备都成功为 0,否则是第一台失败设备的 code |
| list[].id | 字符串 | 设备id |
| list[].code | 整数 | 这台的结果,0 成功 |
| list[].message | 字符串 | 这台的说明 |
| list[].deleted | 整数 | 实际删除的数量(id 不存在的不计入) |
| list[].total_request | 整数 | 请求传入的 id 数 |